home *** CD-ROM | disk | FTP | other *** search
/ Your Choice 3 / Your Choice Software Collection 3.iso / os2 / trashcan / read.me < prev    next >
Encoding:
Text File  |  1994-06-07  |  9.0 KB  |  197 lines
  1. ----------------------------------------------------------------------------
  2.               Workplace Shell TrashCan     Version 1.4
  3.  
  4.                     (c) Kai Sommerfeld 1993,1994
  5. ----------------------------------------------------------------------------
  6.  
  7. IMPORTANT FOR UPGRADING FROM VERSION 1.0 OF WPS TRASHCAN:
  8.         - Due to a bug in install.exe delivered with version 1.0 you must
  9.           delete the trashcan folder manually from the commandline,
  10.           (e.g. rd \desktop\trashcan) BEFORE you install the new version
  11.           using updated install.exe.
  12.  
  13. IMPORTANT FOR USERS OF OS/2 "PERFORMANCE BETA VERSION 2.99":
  14.         - Version 1.0 to 1.3 of TrashCan will not work correctly with this
  15.           OS/2 version! Version 1.4 does.
  16.  
  17. ---------------------------------------------------------------------------
  18. SHORT DESCRIPTION:
  19.  
  20. Workplace Shell TrashCan is a WPS class designed to replace the shredder
  21. object delivered with OS/2 2.x.
  22. It gives you a 'macintosh - like' trashcan on your desktop. There are some
  23. usefull options to handle the trash you 'produce' in your dayly sessions.
  24.  
  25.  
  26. SYSTEM REQUIREMENTS:
  27.        OS/2 2.1 (or higher). The TrashCan will not run under OS/2 2.0,
  28.        because I used methods, API-calls, ..., which are new in OS/2 2.1.
  29.  
  30.        Version 1.4 (and above) of TrashCan will also work with
  31.        "OS/2 Performance Beta" Version 2.99.
  32.  
  33. DISCLAIMER:
  34.        THE SOFTWARE AND ACCOMPANYING DOCUMENTATION ARE PROVIDED "AS IS"
  35.        WITHOUT WARRANTY OF ANY KIND. THE ENTIRE RISK AS TO THE RESULTS AND
  36.        PERFORMANCE OF THE SOFTWARE IS ASSUMED BY YOU.
  37.  
  38.  
  39. INSTALLATION:
  40.         - Just run 'install.exe' from the OS/2 Command prompt or
  41.           doubleclick the 'install.exe' icon.
  42.         - Make sure all suggested pathes are correct.
  43.           (Note: The Path given for the dll must be uncluded in LIBPATH
  44.                  statement of your config.sys)
  45.         - Push the 'Install' button.
  46.         - All nessecary files will now be copied to your hard disk and
  47.           the class library will be registered to WPS.
  48.         - After that the TrashCan object will appear on your desktop.
  49.  
  50.  
  51. DEINSTALLATION:
  52.         ( I hope you'll never do this, accept for upgrading ! )
  53.         - Run install.exe again. The program automatically detects whether
  54.           the TrashCan class library is already installed.
  55.         - After next reboot the TrashCan is gone away ....
  56.  
  57.  
  58. UPDATE TO ANOTHER VERSION OF TRASHCAN:
  59.         - Use install.exe to deinstall the current version of the TrashCan.
  60.           (See: DEINSTALLATION.)
  61.         - ATTENTION: Don't forget to REBOOT after the deinstallation!!!
  62.         - After that follow the steps described under INSTALLATION.
  63.  
  64.  
  65. WHAT DOES IT DO:
  66.         The TrashCan is a folder to keep 'data trash' (any WPS-objects) in
  67.         a save place with the ability of getting it back for use, if
  68.         necessary.
  69.         Otherwise, the TrashCan tries to shred all objects you put into it!
  70.         Means, it also destroys trash, that is generally not deleteable.
  71.         You can move any kind of WPS objects to the TrashCan, accept the
  72.         following:
  73.                 - non moveable objects
  74.                 - objects with an open view (e.g. an opened folder, a
  75.                   running application, a data file currently used by an
  76.                   application)
  77.  
  78.         Objects in the TrashCan only have two context menu items:
  79.                 - 'Move' : Use this to move the selected object(s) out
  80.                            of the TrashCan to any place you want.
  81.                 - 'Shred': Use this to destroy the selected object(s).
  82.          
  83.         Special features you may choose from TrashCan's settings notebook:
  84.  
  85.                 1. Auto empty of the TrashCan every time you start the
  86.                    system.
  87.                 2. You can set a limit for trash hold, if you want to.
  88.                    If this is reached, you must empty the TrashCan, shred
  89.                    one or more objects in the 'Can' or increase the
  90.                    capacity of the TrashCan before you can put more into
  91.                    it. But the default is unlimited trashhold.
  92.                    You may select an auto-delete mode, where the oldest
  93.                    objects in the TrashCan will be deleted automatically,
  94.                    if the limit of trashhold you set, is reached.
  95.                 3. You may change the TrashCan icons to your own favourite.
  96.                    ( Note: Drag and drop is available, but with a little
  97.                            limitation described under BUGS/LIMITATIONS in
  98.                            this document. )
  99.                 4. You may decide to get a confirmation dialog everytime
  100.                    you want to empty the TrashCan. This decreases the 
  101.                    risk of deleting objects by mistake.
  102.  
  103.         And for the MMPM/2 freaks:
  104.                 If you define a sound for 'Shred' in the 'Sound' Notebook
  105.                 (located in 'System Setup' folder), and you select 'Use
  106.                 'shredder' sound' in the 'sound notebookpage' of the
  107.                 TrashCan, you will hear this everytime you drop any object
  108.                 on the TrashCan or you empty it.
  109.  
  110.  
  111.  
  112. HOW MUCH TO PAY FOR WPS TRASHCAN ?
  113.         You don't have to pay anything for the TrashCan. But if you want
  114.         to, send me a nice postcard from your home town.
  115.  
  116.  
  117. KNOWN BUGS / LIMITATIONS:
  118.         1. Don't put a 'printer object' into the TrashCan. If you want to
  119.            destroy it, the system may hang!!! (But I don't know the reason
  120.            for that!!! Does anybody ... ???)
  121.         2. If you want to change the TrashCan's icons using drag and drop
  122.            you cannot drop any object on the "Current icon" field, but
  123.            you must use an *.ico file. All other works the same as assigning
  124.            icons to the "normal" WPS objects.
  125.  
  126. COMMENTS:
  127.         The WPTrashCan class is still under development. It seems to run
  128.         very stable but there may be any bugs anyway!
  129.  
  130.  
  131. REVISION HISTORY:
  132.  
  133. 07.01.94  Version 1.0
  134.         - initial release
  135.  
  136. 01.02.94  Version 1.1
  137.         - user defineable icons implemented 
  138.            (Sounds simple, but belive me, it was a hard job!)
  139.         - some fixes in 'undo' feature in the new notebook pages
  140.         - minor changes in install.exe
  141.  
  142. 18.02.94  Version 1.2
  143.         - created new default icons
  144.         - fixed a bug with drag and drop of large icon files
  145.         - added a frame around the icon displayed in 'Current icon' while
  146.           drag and drop operations, so this is similar to the original
  147.           WPS object's behaviour
  148.         - added 'auto delete on limit-reach' mode to the options notebook
  149.           page
  150.  
  151. 26.02.94  Version 1.3
  152.         - If 'auto delete on limit-reach' is active, and an object larger
  153.           then the specified trashcan capacity is put into the trashcan,
  154.           this object will be deleted immediately; instead of deleteting
  155.           first all old objects and then the new object too (result was
  156.           in v1.2 an empty trashcan!)
  157.         - added a validation check for trashcan capacity on installing,
  158.           moving (to another drive) of the trashcan
  159.         - fixed a bug with drag and drop from other apps to trashcan
  160.           (e.g. from FileManager/2). There was no drop on trashcan possible
  161.           (always stop sign when dragging over).
  162.         - added sound to some TrashCan actions.
  163.           [ Thanks to Robert Novitskey (Big Bad BoB) for the hint how
  164.             to do this! ]
  165.  
  166. 07.06.94  Version 1.4
  167.         - Did some testing with TrashCan and OS/2 2.11 (OS/2 2.1 Service
  168.           Pak XR06200): Result - no problems
  169.         - Changed a small "dirty" code fragment ( Ooops! ) - So this and
  170.           coming versions of TrashCan will work fine with OS/2 "Performance
  171.           Beta" Version 2.99, too
  172.         - Added a 'Change' button to 'Sound options' notebook page, which
  173.           opens the 'Sound' notebook in the 'System Setup' folder.
  174.         - Added a 'Find ...' button to 'Icons' notebook page. Now searching
  175.           for icons works most similar to all other WPS objects.
  176.         - Added 'Confirm on trashcan empty' checkbox to 'Options' notebook
  177.           page.
  178.           So you may decide to confirm the deleting of TrashCan's content. 
  179.         - The trashsize and the count of objects are now displayed in the
  180.           Icon View of the TrashCan
  181.         - 'Empty' Trashcan and 'Shred' of object(s) via popup menu work
  182.           now in a separate thread. So the WPS doesn't block while
  183.           performing this tasks.
  184.         - Fixed a bug in 'install.exe': If the old trashcan.dll and/or
  185.           trashcan.hlp are/is 'read only', a reinstallation/update failed.
  186.     
  187. ----------------------------------------------------------------------------
  188. Send any comments / bug reports to:
  189.  
  190.         Kai Sommerfeld
  191.         Hochschulstr. 48  07/08
  192.         D-01069 Dresden
  193.         GERMANY
  194.  
  195.         or just email me:  ks1@irz.inf.tu-dresden.de
  196. ----------------------------------------------------------------------------
  197.